home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 35 / q35.d81 / magic docs < prev    next >
Text File  |  2022-08-28  |  41KB  |  925 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                   
  7.                   Page          Table of Contents
  8.                   
  9.                   
  10.                   1             Getting Loaded
  11.                   1             The Launch...
  12.                   1             Set The Drive Number
  13.                   1             Getting Our Feet Wet
  14.                   2             The Status Line
  15.                   2             The Logo / User Interface Line
  16.                   3             HELP Me PLEASE!
  17.                   3             Navigation
  18.                   3             GRABbing Files
  19.                   4             Now That I GRABbed it, What Can I DO With It?
  20.                   4                Move It
  21.                   4                Swap It
  22.                   4                Rename It
  23.                   4                Change File Type
  24.                   4                Lock It
  25.                   5                Scratch It
  26.                   5                Unscratch It
  27.                   5                Oops!
  28.                   5                A Sorted Affair
  29.                   6                Moving Scratches    [ooh!]
  30.                   6                WunderBars
  31.                   8             Dont Forget To Write
  32.                   8             BAM!
  33.                   8             Partition Processing
  34.                   8             Conquering Divides
  35.                   10            DOS Operations
  36.                   11            Renaming a Disk
  37.                   12            Directory to Printer
  38.                   12            Disk Files to Printer
  39.                   12            And Finally...
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                                 Magic 128 V1.16
  70.                                                                 by e.g.bell    
  71.                   
  72.      ***          Getting Loaded
  73.      
  74.      
  75.      Magic 128 is a 1581 directory manipulator that also supports 1541 and
  76.      1571 format disks.  The program was written in machine language for
  77.      speed.  The name was inspired by a C64 mode program that I was always
  78.      so impressed with, called Directory Magic.  It was one of my very
  79.      favorite utilities for the C64.  I wanted something that did
  80.      everything Directory Magic did, and a lot more.  I think you'll find
  81.      Magic 128 every bit as useful, and maybe quite a bit more.  
  82.      
  83.      To get started, all you have to do is type
  84.      
  85.      Ex 1:        run "Magic 128*"
  86.                          or    
  87.      Ex 2:        run "Magic 128*",u#             Where #=Drive Number
  88.      
  89.      You can run Magic 128 from LOADSTAR by choosing Run It.
  90.      
  91.      The program will load and begin executing.  The first thing it does is
  92.      load a support file called  BURST SUBS.BIN+ from the same disk drive.
  93.      Make sure you have the two files on the same disk.  
  94.      
  95.      If you aren't using drive 8 for your source drive, make sure you use a
  96.      RUN statement like the second example above, specifying your drive
  97.      number after the U.  Magic 128 will load the support file from
  98.      whatever drive you start out with.  The BURST SUBS.BIN+ file is the
  99.      one included on the 1581 demo disk along with a little code I added
  100.      for Magic 128.  You MUST use my version to get the extra code Magic
  101.      128 needs.
  102.      
  103.      ***          The Launch...
  104.      
  105.      When the loading is all done, you will be facing a HELP screen of many
  106.      of the command options of Magic 128.  Press a key to get to the work
  107.      screen.  The work screen will be blank with a box pointer flashing in
  108.      the upper left corner of the work area.  The work screen is where you
  109.      will be able to execute the functions of Magic 128.  No commands work
  110.      while in the HELP mode.
  111.      
  112.      Insert a disk.  It is best to start with a backup disk first, until
  113.      you get comfortable with Magic 128.   
  114.      
  115.      ***          Set The Drive Number
  116.      
  117.      The drive you load Magic 128 from is the drive that will be used for
  118.      subsequent Magic operations.  You can change this if you like, by
  119.      pressing CTRL-d from the work screen.  This will allow you to specify
  120.      what drive you would like to use.  The acceptable range is from 8 to
  121.      30.  In this regard, if you use the Xetec Super Gold Interface for
  122.      your printer, don't use device 14 for your drive.  This is a reserved
  123.      device number used with a burst driver for that interface.
  124.      
  125.      ***          Getting Our Feet Wet
  126.      
  127.      Press r to read the disk, and the screen will blank.  When it comes
  128.      back, you will be looking at a screen formatted in up to 4 columns
  129.      containing the filenames from the directory of the disk you have just
  130.  
  131.                                       Page 1
  132.  
  133.  
  134.  
  135.                                                             Magic 128 V1.16
  136.                                                             by e.g.bell    
  137.      
  138.      read.  There are up to 20 files in a column, meaning up to 80
  139.      filenames can be displayed on a screen.
  140.      
  141.      To the right of each filename is a : character followed by the first
  142.      letter of the filetype of that directory entry.  Splat files will show
  143.      a * in this position.  Locked files will show a < just before the
  144.      colon.  This is a lot of information in a little space, but you'll get
  145.      used to it.   Operation speed dictated doing things like this.
  146.      Attributes (reverse, color, flashing, etc.) are not available in the
  147.      main work screen.
  148.      
  149.      If there are more than 80 files on the disk, there will be 1 or more
  150.      additional pages of the same format, up to 4 pages total.  Magic 128
  151.      will accomodate a full 1581 directory of up to 296 files, as well as
  152.      handling 1541 and 1571 diskettes.  Note!  The pages are all in VDC
  153.      memory at the same time, which means pages don't have to be repainted
  154.      each time.  Everything is quick...a twiddled bit's distance from one
  155.      page to the next.
  156.      
  157.      ***          The Status Line
  158.      
  159.      The two lines at the bottom of every Magic 128 screen are
  160.      informational lines. They tell you the status of the disk directory
  161.      and the file in the GRAB buffer. If you have not GRABbed a file, this
  162.      line will only display information about the disk you have in the
  163.      drive [you must Read the disk by pressing r first]  If you have
  164.      GRABbed a file, then the filename will be displayed, along with its
  165.      locked/unlocked status, file type, starting track and sector, and size
  166.      in disk blocks.
  167.      
  168.      The MODE header on this informational line tells you what mode you are
  169.      in.  If you have a file GRABbed, the MODE is DUMP, meaning that you
  170.      cannot GRAB another file.  If no file is GRABbed, the MODE is GRAB,
  171.      meaning you can pick up a file.
  172.      
  173.      The FREE and USED columns tell you how many blocks on the disk are
  174.      used and how many are available.  The FILES column tells you how many
  175.      active files are on the disk, and DEL tells you how many deleted files
  176.      there are.  
  177.      
  178.      The DVC column tells you what drive is in use, either 41 (1541), 71
  179.      (1571), or 81 (1581).  It could also say ?, which means the drive is
  180.      not recognized.  The information is determined using a drive reset and
  181.      then reading the standard DOS error message returned.  This
  182.      information is pulled in at startup, and several times during
  183.      execution of Magic 128.  You can force such an inquiry by pressing
  184.      CTRL-w.  
  185.      
  186.      Note!  I said this is done using a drive reset.  This means that if
  187.      you use software or a  DOS command to set your device number, you are
  188.      going to have a problem with this program.  To use it, switch all of
  189.      your other drives off, and just use drive 8.  This should only even be
  190.      a concern to 1541 users or 128D users with no switches on their
  191.      drives.
  192.      
  193.      ***          The Logo / User Interface Line
  194.  
  195.                                       Page 2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                             Magic 128 V1.16
  202.                                                             by e.g.bell    
  203.      
  204.      
  205.      The user interface line, where Magic 128 gets most keybo